home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr34 / lhe101.zip / ELHE.DOC next >
Text File  |  1995-02-25  |  6KB  |  120 lines
  1. LHE SuperFast LZH Extract Utility Ver 1.01E
  2.   Copyright 1995 by Kunihiko Sadakane        sada@is.s.u-tokyo.ac.jp
  3.   Translated by Hitoshi Ozawa            CompuServe: 100220,3402
  4.  
  5. 1. Introduction ***************************************************************
  6.   LHE is an MS-DOS utility for extracting files from files with LZH extenstions
  7. (i.e., files compressed by means of the LHA utility).  It is fully compatible
  8. with LHA versions 0, 1, 4, 5, 6, and d.
  9.  
  10. 2. How to Use *****************************************************************
  11.     usage: LHE [exlv] [-qancmx] LZH file [DIR\] [FILES]
  12.  
  13.   (a) In place of "LZH file", enter the name of the file with LZH extension
  14.       whose content is to be extracted or listed. 
  15.   (b) In place of "[DIR\]", enter the name of the directory in which extracted
  16.       files are to
  17.       be created.  To differentiate it from the file name, please append a
  18.       "\" or a "/" character to the end of the directory name.
  19.       If this is omitted, files will be created in the current directory.
  20.  
  21.  NOTES:
  22.   (a) The characters "\" and "/" may be used as directory separators.
  23.   (b) The LZH extension may be omitted from a file name.
  24.   (c) The wild card characters "*" and "?" may be used to specify files.
  25.   (d) The content of a file can be used in the command line by prefixing the
  26.       file name with an "@" character.
  27.   (e) If standard input is being redirected, the contents are appended to the
  28.       end of the command line.
  29.  
  30. 3. Parameters *****************************************************************
  31.   (a) Commands [exlv]
  32.     e   Extract files
  33.     x   Extract files and directories (same as  LHE e -x1m1)
  34.     l   List contained files
  35.     v   List contained files and directories (same as LHE l -x1)
  36.   (b) Options [-qancmx]
  37.      Options all have a format -(option)(number).  Example: -m0
  38.      (1) -q  CRC check files
  39.     Check for extraction of corrupt files.
  40.     File corruption is usually also checked for by size, so this option
  41.      is usually unnecessary.
  42.     Specifying this option will reduce the extraction speed by 20%.
  43.      (2) -a  Extract with Attributes of files
  44.      (3) -n  Shorten messages
  45.          -n1  Do not display ellipsis points.
  46.          -n2  Do not display all messages.
  47.           When used with an -m option, -m0 will automatically be
  48.            treated as -m1
  49.           When used with an -l option, only file names will be 
  50.            displayed.
  51.      (4) -c  Overwrite all files
  52.     Overwrite all existing files with the same name.
  53.      (5) -m  -m0  Display a prompt message when the file already exists.
  54.           An "overwrite(Yes/No/All/Rename)?" prompt will apprear.
  55.               Enter
  56.             Y    to overwrite the specified file
  57.             N   to skip extraction of this file
  58.             A   to overwrite all remaining files without a prompt
  59.             R   to automatically number file extensions on all
  60.             remaining files (similar to -m2c1 on remaining files)
  61.          -m1  Overwrite existing files
  62.          -m2  Change extensions automatically to number them from 000 to 999.
  63.      (6) -x  Extract subdirectories
  64.     Create a compressed subdirectory during the file extraction.  To 
  65.     minimize the number of rows during the extraction, use -x2.  With this
  66.     option, file descriptions will be displayed in just two rows as
  67.     necessary.
  68.      (7) -]  Extract only files with different dates (only effective with
  69.              the -m2 option)
  70.     If a file already exists, skip it if it has the same date or change
  71.     the extension of the extracted file if it has a different date.
  72.       -]m2c1 is the same as -m2
  73.  
  74.     NOTE:    
  75.      (1) If a number is omitted, it will be treated as 1 if the current state
  76.      is 0 and as 0 otherwise. Example: -m is treated as -m1 if the current
  77.      state is -m0 and as -m0 if it is not.
  78.      (2) A "+" or a "-" sign may be used instead of 1 or 0, respectively.
  79.      Example: -c+ instead of -c1
  80.      (3) The default value on all options is 0.
  81.      (4) Options may be combined. Example: -cm1
  82.      (5) Options may be defined as DOS parameters.  Example: SET LHE=-q]
  83.  
  84. 4. Suggested Usage ************************************************************
  85.   LHE.COM can be used with LHA.EXE to simplify file compression and extraction
  86. operations, while retaining the speed of LHE.COM file extraction.  
  87.   (a) Rename LHE.COM as LHA.COM  (REN LHE.COM LHA.COM)
  88.   (b) Move LHA.COM to the same directory as LHA.EXE.
  89. Use the LHA command to compress and extract files.  If LHA.COM encounters a
  90. parameter that it does not support, it will activate and pass the parameters
  91. to the LHA.EXE program.
  92.  
  93.   NOTE: LHA.EXE can be specified by inserting a ";" or a "=" directly after
  94.     "LHA".  Example: LHA; E *.LZH aaa\bbb.c
  95.  
  96. 5. WARNINGS *******************************************************************
  97.     (a) If a file name begins with the character "-", insert an addition "-" to
  98.     specify that the following character is not an option.
  99.     Example: To extract from a file named -aaa.lzh, type LHA e --aaa.lzh.
  100.     (b) If a file name begins with the character "@", insert a "-" before the
  101.     file name.
  102.     Example: To extract from a file named @aaa.lzh, type LHA e -@aaa.lzh
  103.     (c) If the standard output is redirected, the -n0 option will be treated as
  104.     -n1 and the -m0 option will be treated as -m1.
  105.     (d) The -]m2 option behaves differently from LHE ver 1.00.
  106.     (e) Root directory path specification in the LZH file is ignored.
  107.     (f) A directory may NOT be specified in the [FILES].
  108.     (g) Only one output directory may be specified.
  109.     (h) LHE does not support the 64K dictionary in -lh6-.
  110.  
  111. 6. Releases *******************************************************************
  112.   Ver 1.0a    - Support extraction with attributes of files
  113.   Ver 1.01    - Support file listing
  114.         - Increase extraction speed (10% to 20%)
  115.         - Fix file if an extraction error occurs
  116.         - Support switching to LHA.EXE program internally
  117.         - Change file name not supported by MS-DOS
  118.         - Support redirection
  119.   Ver 1.00    - Initial release
  120.